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: ! ELEMENT serial. ports (#PCDATA)> 
: ! ATTLIST serial. ports 
% common . attrib ; 



! ELEMENT inf . serial . ports (#PCDATA)> 
! ATTLIST inf .serial. ports 
% common . attrib ; 



:! ELEMENT parallel . port (A 
: ! ATTLIST parallel. port 
% common. attrib ; 



: ! ELEMENT extended . parallel . protocols (other?, A?, B? , C?)> 
:! ATTLIST extended. parallel. protocols 
% common. attrib ; 



:! ELEMENT keyboard. mouse . port . type (other | A | B | C 
: ! ATTLIST keyboard . mouse . port . type 
%common. attrib ; 



:! ELEMENT mouse . port . type (other 
:! ATTLIST mouse. port. type 
..attrib; 



: ! ELEMENT other . port . set (other .port+) > 
: ! ATTLIST other .port . set 
%common. attrib ; 



:! ELEMENT other. port (# PCDATA )> 
:! ATTLIST other. port 
% common. attrib ; 



<! ELEMENT accessory (accessory .purpose, 

accessory. replaces, accessory .works .with) > 

<! ATTLIST accessory 
% common. attrib ; 



: ! ELEMENT accessory . purpose (#PCDATA)> 
: ! ATTLIST accessory. purpose 
% common. attrib ; 



<! ELEMENT accessory . replaces (#PCDATA)> 
<! ATTLIST accessory. replaces 
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< ! ELEMENT accessory . works . with (#PCDATA)> 
< ! ATTLIST accessory. works. with 
%common.attrib; 
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<! — isrvprim.mod Version: 0.1 — > 

<! — Purpose: provide primitives for service descriptions 

<!— Terry Allen 2 Jan 1998 — > 

<! — Copyright 1998 CNgroup, Inc. — > 

<! ELEMENT service (service. name, 

service . function . sequence+ , service . location . pointer* , 

contact* ) > 
< ! ATTLIST service 

% common. attrib; 



<! ELEMENT service 
<! ATTLIST service 
%common.attrib 



<! ELEMENT service . function . sequence ( service . function+) > 
<! ATTLIST service . function . sequence 
%common. attrib; 



<! ELEMENT service . function (doctypet, service . location* ) > 
<! ATTLIST service. function 
%common . attrib; 



<! ELEMENT doctype (#PCDATA)> 
<! ATTLIST doctype 

% common .attrib ; 

%party. attrib; 

%f rom. party . attrib; 

%to . party . attrib ; 



<! ELEMENT action EMPTY> 
<! ATTLIST action 

verb (register | retrieve | query | unregister | notariz 
I act. upon ) # REQUIRED 



<! ELEMENT service . location . pointer ( %xll . or . urn; ) > 
< ! ATTLIST service . location . pointer 
%common. attrib; 

cblpointer CDATA #FIXED "outside" 



.name (#PCDATA)> 



<! ELEMENT contact ( contact . function* , personal . name* , 
language . understood* , 

occupation. title? , occupation . code? , address . set+) > 
<! ATTLIST contact 
% common. attrib ; 



<! ELEMENT contact . function (#PCDATA)> 
<! ATTLIST contact. function 
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:! ELEMENT language . understood EMPTY> 
: ! ATTLIST language .understood 
%lang . attrib . required; 
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<!— itaxo.dtd Version: 0.1 — > 

<! — Purpose: define taxonomy structure for Ingram Micro demo ■ 

<i— Terry Allen 5 Jan 1998 — > 

<! — Copyright 1998 CNgroup, Inc. — > 

<! ENTITY % common SYSTEM "icommatt .mod"> 



<! ENTITY % pointers SYSTEM "ipointer .mod": 
%pointers; 

<! ELEMENT taxon (taxon.name, taxon.id, 

taxon . inf o? , taxon . parent . pointer* , 
{taxon. child. pointer | taxon) *)> 
< ! ATTLIST taxon 
% common . attrib; 



:! ELEMENT taxon. nam 
:! ATTLIST taxon. nam 
% common. attrib; 



:! ELEMENT taxon.id {#PCDATA)> 
:! ATTLIST taxon.id 
% common. attrib ; 



:! ELEMENT taxon. info (#PCDATA)> 
:! ATTLIST taxon. info 
%common . attrib ; 
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<?xml version="l . 0"?> 

<! — itaxo.xml Version: 0.2 — > 

<! — Purpose: part of Ingram Micro taxonomy — > 

<!— Terry Allen 5 Jan 1998 — > 

<! — Copyright 1998 CNgroup, Inc. — > 

<!DOCTYPE taxon SYSTEM "itaxo . dtd"> 
<taxon> 

<taxon.name>Ingram Micro Taxonomy of Computer Goods 

<taxon . id>ingram: root 
</taxon.id> 

<taxon. info>Everything Ingram Micro sells 
</taxon.info> 
<taxon> 

<taxon.name>Computer Systems 
</taxon.name> 
<taxon. id>ingram: 00 
</taxon.id> 

<taxon. inf o>Computers and some components 
</taxon.info> 
<taxon> 

<taxon.name>Desktop Computers 

</taxon.name> 

<taxon. id>ingram: 00.01 

</taxon.id> 

<taxon.info>Stub for first subdivision 

</taxon.info> 

</taxon> 

<taxon> 
<taxon . name>Tower Computers 
</taxon.name> 
<taxon. id>ingram: 00 . 03 
</taxon.id> 

<taxon. info>Stub for second subdivision, all other subdivisions 

omitted save for no. 11 
</taxon. inf o> 
</taxon> 

<taxon> 

<taxon.name>Portable Computer, Memory Samp; Accessories 

<taxon. id>ingram: 00 . 11 
</taxon.id> 

<taxon. inf o>Laptops , etc., not further categorized in this 

taxonomy 
</taxon.info> 
</ taxon> 
</taxon> 
</taxon> 
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<!— ithink.xml Version: 0.1 — > 

<! — Purpose: inventory request for Ingram Micro demo — > 
<! — Terry Allen 5 Jan 1998 — > 
<!— Copyright 1998 CNgroup, Inc. — > 

<?xml version="l . 0"?> 

<!DOCTYPE reguest. for. info SYSTEM "iireq.dtd"> 

<request . for . inf o> 
<inf o . description . set> 
<inf o . description> 
<xml . descriptor> 

<doctype><dtd systemid="iinv. dtd"/x/doctype> 
<xml . descriptor . details> 

<xll . xptr . f rag>ROOT ( ) ( 1 , line . description . one ) STRING ( ThinkPad 770) 
</xll . xptr . f rag> 

<xll . xptr . f rag>ROOT ( ) ( 1 , pentium-mmx) 

</ xll . xptr . f rag> 

</xml . descriptor . details> 

</xml . descriptor> 

</inf o . description> 

</inf o . description . set> 

</request . for . inf o> 
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<?xml version="1.0"?> 

<!— think. xml Version: 0.1 — > 

<! — Purpose: IBM product description for Ingram Micro demo 
<!— Terry Allen 3 Jan 1998 — > 
<!— Copyright 1998 CNgroup, Inc. — > 

<!DOCTYPE product. description SYSTEM "iprod.dtd"> 

<product . description> 
<meta> 

<urn>urn : x-cbl : ISBN%2 00-94 4 94 0 : test : companies : ibm: 000001 
</meta> 

<general . product . inf o> 
<product . identity> 

<product . id assigned. by="manufacturer">TBS 
</product . id> 

<product . id assigned. by="ingram"> 
</product . id> 

<ingram. taxonomy . category>ingram: 00 . 11 
</ ingram. taxonomy. category> 



</product . identity> 
<bundling . and . shipping> 



<open . branch . warehouse . number> 

</ open . branch . warehouse . number> 

<case . pack . quantity> 

</case . pack . quantity> 

<pallet . quantity> 

</pallet . quantity> 

<weight . per . unit> 

</weight . per . unit> 

<unit . of . weight> 

</unit.of .weight> 

<shippable . carton . f lag> 

</ shippable . carton . f lag> 

<product . sn . on .box yesorno="yes"/> 

<barcoded . sn . on . box yesorno="yes " /> 

<package . length> 

</package . length> 

<package . width> 

</package . width> 

<package . height> 

</package .height> 

<unit.of .size> 

</unit.of .size> 

</upc> 

<container . upc> 
</container . upc> 
<bill . of .materials> 
</bill . of .materials> 
<media . codes> 
</media . codes> 
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<cpu. codes> 
</ cpu . codes> 

<line . description . one>ThinkPad 7 70 

</line . description . one> 

<line . description . two> 

</line . description . two> 

<sales . description> 

</ sales . description> 

<selling. bullet. set> 

<selling.bullet> 

</ selling. bullet> 

<selling.bullet> 

</selling.bullet> 
</selling. bullet. set> 
<requirements . set> 
<requirement> 
</requirement> 
<requirement> 
</requirement> 
</requirements . set> 
< /bundling . and . shipping> 

</general .product . inf o> 

Supplemental . product . inf o> 

<options . accessories> 

</ options . accessor ies> 

<addon . consumables> 

</ addon . consumables> 
</supplemental .product . inf o> 

<product . dimensions . and . warranty> 

<physical . dimensions> 

<product . length> 

</product . length> 

<product . width> 

</product . width> 

<product . height> 

</product .height> 

<product . weight> 

</product . weight> 
</physical . dimensions> 

<warranty . inf o> 
<standard. warranty> 
</standard . warranty> 
<onsite . support yesorno="yes"/> 
<onsite.yr2 yesorno="yes"/> 
<onsite.yr3 yesorno="yes"/> 
<next . day. support yesorno="yes"/> 
<remarks> 
</remarks> 

</warranty . info> 

</product . dimensions . and. warranty> 
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<product . specif ications> 

<physical . specs> 

<system. type><A/> 
</ system. type> 
<battery . type><B/> 
</battery . type> 
<est.batt.life> 
</est.batt.life> 
<batt . recharge . time> 
</batt . recharge . time> 
<number . batteries . included> 
</number . batteries . included> 
<max . no . batts . installable> 
</max . no . batts . installable> 
<power . management> 
</power .management> 
<energy.star yesorno="yes"/> 
<voltage . supported><C/> 
</voltage . supported> 
<ac . adapter . type><A/> 
</ ac . adapter . type> 
<ac . adapter . capacity> 
</ac . adapter . capacity> 
<security. feature . setXA/> 
</security . feature . set> 
<pointing . device><A/> 
< /point ing. device> 
<number . buttons . pd> 
</number .buttons .pd> 
<pd. location><A/> 
</pd. location> 
<docking. station> 
</docking . station> 
<os.set> 
<os>nt 

<os>win95 
</os> 
<os>win95 
</os> 
</os . set> 

<system. license><A/> 
</ system. license> 
<bundled. sof tware> 

<sof tware . product> 

</sof tware . product> 
</bundled. sof tware> 
<net . interf ace><B/> 
</net . interf ace> 
<net . management . included> 
</net .management . included> 

</physical . specs> 
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<processor> 

<p e n t i um-mmx / > 
</processor> 
<p . speed. set> 
<p.speed>2 00 
</p . speed> 
<p. speed>233 
</p . speed> 
</p . speed. set> 
<p . upgrade . method> 
</p .upgrade .method> 
<ram. installed> 
</ram.installed> 
<ram.max> 

<ram. typexotherx/ other> 

</ram. type> 

<ll.cache> 

</ll . cache> 

<12 .cache> 

</12 .cache> 

<12.type><B/> 

</12.type> 

<bios .manufacturer><A/> 

</bios .manuf acturer> 

<f lash . upgrade . bios yesorno="yes "/> 

<hard. disk. capacity . set> 

-chard, disk. capacity>3 . 2 

</hard.disk. capacity> 

<hard. disk. capacity>4 

</hard.disk. capacity> 

<hard. disk. capacity>5 . 1 

</hard. disk. capacity> 

</hard. disk. capacity. set> 

<h . d . interf ace><B/> 

</h.d. interface> 

<h . d . user . removable yesorno="no " /> 
<removable . drive . set><A/> 
</removable . drive . set> 
<small . floppy . drive . type><A/> 
</ small . floppy . drive . type> 
<cdrom. speed><C/> 
</cdrom. speed> 
<number . mod . bays> 
</number .mod.bays> 
<bayl . support . set><A/> 
</bayl . support . set> 
<bay2 . support . set><A/> 
</bay2 . support . set> 
<other .mass . storage . set> 
<other .mass . storage> 
</other .mass . storage> 
</other .mass . storage . set> 
</cpu> 

<audio.video> 
<display. techxA/> 
</display.tech> 
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<d. size . set> 
<d.size>13.3 
</d. size> 
<d.size>14.1 
</d.size> 
</d.size.set> 
<video . bus . type><A/> 
</video . bus . type> 
<v. memory . installed> 
</v . memory . ins talled> 

</ v. memory .max> 

<v . memory . type><A/> 

</v. memory . type> 

<d.res><A/> 

</d.res> 

<color .palette><A/> 

</color .palette> 

<ex.monitor><A/> 

</ex.monitor> 

<ex .monitor .max . res><A/> 

</ex. monitor .max. res> 

<ex . color .palette><A/> 

</ex. color .palette> 

<sound . support . compat><A/> 

</ sound. support . compat> 

<midi><A/> 

</midi> 

<full. duplex yesorno="yes"/> 

<audio . ports><A/> 

</audio .ports> 

<internal . speakers><A/> 

</internal . speakers> 

<builtin . mphone yesorno="yes " / > 

<builtin .modem yesorno="yes"/> 

<speakerphone yesorno="yes"/> 

<voicemail yesorno="yes"/> 

<f lash . upgrade . modem yesorno="yes " /> 
</audio . video 
<portex> 

<system. bus . type><A/> 

</ system. bus . type> 

<pcmcia . slots><A/> 

</pcmcia . slots> 

<cardbus .pccard yesorno="yes"/> 

<zv.pccard yesorno="yes"/> 

<pds . slots> 

</pds.slots> 

<ex . scsi . connector><A/> 

</ex. scsi.connector> 

<serial.ports> 

</serial.ports> 

<inf . serial . ports> 

</inf. serial .ports> 

<parallel . port><A/> 

</parallel .port> 

<extended. parallel .protocols><A/> 
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</extended . parallel . protocols> 

<keyboard. mouse .port . type><A/> 

</keyboard. mouse .port . type> 

<mouse . port . type><A/> 

</mouse .port . type> 

<other .port . set> 

<other .port> 

</other .port> 

</other .port. set> 
</portex> 
<accessory> 

<accessory . purpose> 

</accessory .purpose> 

<accessory . replaces> 

</accessory . replaces> 

<accessory. works .with> 

</accessory. works . with> 
</accessory> 
</product . specif ications> 

</product . description> 
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<! — thinkcat . xml Version: 0.1 — > 

<! — Purpose: catalog entry for Ingram Micro demo — > 

<!— Terry Allen 5 Jan 1998 — > 

<! — Copyright 1998 CNgroup, Inc. — > 

<?xml version="l . 0"?> 

<!DOCTYPE catalog. entry SYSTEM "icat.dtd"> 
<catalog . entry> 

<market . participant . info . pointer> 

<xll . locator urllink="ingram. xml"/> 

</market . participant . info . pointer> 

<catalog . entry. id>ingthink77 0 

</catalog . entry. id> 

<product . description . info .pointer> 

<xll . locator urllink="think. xml"/> 

</product . description . info . pointer> 

<price . info>TBS 

</price.info> 

</ catalog. entry> 
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<!-- ttlattri.mod Version: 0.21 — > 

<! — Purpose: group time-to-live attributes — > 

<!— Terry Allen 5 Oct 1997 — > 

<! — Copyright 1997 CNgroup, Inc. — > 

<! ENTITY % ttl.attrib 

"commences CDATA #IMPLIED 
expires CDATA #IMPLIED" 
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Exhibit I. Glushko, Robert J., Implementing Domain-specific 
Commerce Languages with a Common Business Library, Slides 29-31 
(delivered July 25, 1998) accessed at 

http://groups.haas.berkeley.edu/citm/conferences/cec/Presentations/ 
Session3/ glushko.pdf on October 26, 2006 
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Abstract 

WSDL is an XML format for describing network services as a set of endpoints operating on messages containing either 
document-oriented or procedure-oriented information. The operations and messages are described abstractly, and then 
bound to a concrete network protocol and message format to define an endpoint. Related concrete endpoints are combined 
into abstract endpoints (services). WSDL is extensible to allow description of endpoints and their messages regardless of 
what message formats or network protocols are used to communicate, however, the only bindings described in this 
document describe how to use WSDL in conjunction with SOAP 1.1, HTTP GET/POST, and MIME. 

Status 

This document is a submission to the World Wide Web Consortium (see Submission Re quest , W3C S taff Comment ) as a 
suggestion for describing services for the W3C XML Activity on XML Pro tocols. For a full list of all acknowledged 
Submissions, please see Acknowledged Submissi ons to W3C . 

This draft represents the current thinking with regard to descriptions of services within Ariba, IBM and Microsoft. It 
consolidates concepts found in NASSL, SCL, and SDL (earlier proposals in this space). 

This document is a NOTE made available by the W3C for discussion only. Publication of this Note by W3C indicates no 
endorsement by W3C or the W3C Team, or any W3C Members. W3C has had no editorial control over the preparation of 
this Note. This document is a work in progress and may be updated, replaced, or rendered obsolete by other documents at 
any time. 

A list of current W3C technical documents can be found at the Technical Re ports page. 
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1. Introduction 



As communications protocols and message formats are standardized in the web community, it becomes increasingly 
possible and important to be able to describe the communications in some structured way. WSDL addresses this need by 
defining an XML grammar for describing network services as collections of communication endpoints capable of 
exchanging messages. WSDL service definitions provide documentation for distributed systems and serve as a recipe for 
automating the details involved in applications communication. 

A WSDL document defines services as collections of network endpoints, or ports. In WSDL, the abstract definition of 
endpoints and messages is separated from their concrete network deployment or data format bindings. This allows the 
reuse of abstract definitions: messages, which are abstract descriptions of the data being exchanged, and port types 
which are abstract collections of operations. The concrete protocol and data format specifications for a particular port type 
constitutes a reusable binding. A port is defined by associating a network address with a reusable binding, and a collection 
of ports define a service. Hence, a WSDL document uses the following elements in the definition of network services: 

• Types- a container for data type definitions using some type system (such as XSD). 

• Message- an abstract, typed definition of the data being communicated. 
. Operation- an abstract description of an action supported by the service. 

• Port Type-an abstract set of operations supported by one or more endpoints. 

• Binding- a concrete protocol and data format specification for a particular port type. 

• Port- a single endpoint defined as a combination of a binding and a network address. 

• Service- a collection of related endpoints. 
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These elements are described in detail in Section 2. It is important to observe that WSDL does not introduce a new type 
definition language. WSDL recognizes the need for rich type systems for describing message formats, and supports the 
XML Schemas specification (XSD) [11] as its canonical type system. However, since it is unreasonable to expect a single 
type system grammar to be used to describe all message formats present and future, WSDL allows using other type 
definition languages via extensibility. 

In addition, WSDL defines a common binding mechanism. This is used to attach a specific protocol or data format or 
structure to an abstract message, operation, or endpoint. It allows the reuse of abstract definitions. 

In addition to the core service definition framework, this specification introduces specific binding extensions for the 
following protocols and message formats: 

. SOAP 1.1 ( see Section 3 ) 

. HTTP GET / POST (see Section 4 ) 

• MIME ( see Secti on 5) 

Although defined within this document, the above language extensions are layered on top of the core ser vice definit ion 
framework. Nothing precludes the use of other binding extensions with WSDL. 

1 .2 WSDL Document Example 

The following example shows the WSDL definition of a simple service providing stock quotes. The service supports a single 
operation called GetLastTradePrice, which is deployed using the SOAP 1.1 protocol over HTTP. The request takes a ticker 
symbol of type string, and returns the price as a float. A detailed description of the elements used in this definition can be 
found in Section 2 (core language) and Section 3 (SOAP binding). 

This example uses a fixed XML format instead of the SOAP encoding (for an example using the SOAP encoding, see 
Example 4 ). 

Example 1 SOAP 1.1 Request/Response via HTTP 
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1.2 Notational Conventions 

1. The keywords "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", 
"RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in RFC-21 19 £2J. 



2. The following namespace prefixe 



e used throughout this document: 



prefix 
wsdl 
soap 



namespace URI 

http://schemas.xmlsoap.org/wsdl/ 



http://schemas.xmlsoap.org/wsdl/soap/ 
http http://schemas.xmlsoap.org/wsdl/http/ 
mime http://schemas.xmlsoap.org/wsdl/mime/ 
soapenc http://sche mas.xmls oap.orci/soap/encoding / 
soapenv htt p ://schemas .xmlsoap.o r g/soap/en velope/ 



WSDL namespace for WSDL SOAP 
binding. 

WSDL namespace for WSDL HTTP 
GET & POST binding. 

WSDL namespace for WSDL MIME 
binding. 

Encoding namespace as defined by 
SOAP 1.1 18]. 

Envelope namespace as defined by 
SOAP 1.1 18]. 



http://www.w3.org/2000/10/XMLSchema 
(various) 



(other) (various) 



Schema namespace as defined by 
XSD [10], 

The "this namespace" (tns) prefix is 
used as a convention to refer to the 
current document. 

All other namespace prefixes are 
samples only. In particular, URIs 
starting with "http://example.com" 
represent some application-dependent 
or context-dependent URI [4J. 



3. This specification uses an informal syntax to describe the XML grammar of a WSDL document: 

• The syntax appears as an XML instance, but the values indicate the data types instead of values. 

• Characters are appended to elements and attributes as follows: "?" (0 or 1), "*" (0 or more), "+" (1 or more). 

• Elements names ending in (such as <element.../> or <element...>) indicate that elements/attributes irrelevant tc 
the context are being omitted. 

. Grammar in bold has not been introduced earlier in the document, or is of particular interest in an example. 
. <- extensibility element --> is a placeholder for elements from some "other" namespace (like ##other in XSD). 
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